Node / meshtastic / Meshtastic-Android / files / androidApp / src / testGoogle / kotlin / org / meshtastic / app / map / offline / pmtiles / OfflineRegionStoreTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.app.map.offline.pmtiles

Tff7b72import T7ee787kotlinx.coroutines.test.runTest

Tff7b72import T7ee787java.io.File

Tff7b72import T7ee787kotlin.test.AfterTest

Tff7b72import T7ee787kotlin.test.BeforeTest

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertFalse

Tff7b72import T7ee787kotlin.test.assertTrue

Tff7b72class T56d364OfflineRegionStoreTest Tb4b4b4{

Tff7b72private Tff7b72lateinit Tff7b72var Te6edf3baseDirTb4b4b4: Te6edf3File

Tff7b72private Tff7b72lateinit Tff7b72var Te6edf3storeTb4b4b4: Te6edf3OfflineRegionStore

Tf0883e@BeforeTest

Tff7b72fun Td2a8ffsetUpTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3baseDir Tff7b72=

Te6edf3FileTb4b4b4.Te6edf3createTempFileTb4b4b4(Ta5d6ff"Ta5d6ffoffline-region-storeTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3apply Tb4b4b4{

Te6edf3deleteTb4b4b4(Tb4b4b4)

Te6edf3mkdirsTb4b4b4(Tb4b4b4)

Tb4b4b4}

Te6edf3store Tff7b72= Te6edf3OfflineRegionStoreTb4b4b4(Te6edf3baseDirTb4b4b4)

Tb4b4b4}

Tf0883e@AfterTest

Tff7b72fun Td2a8fftearDownTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3baseDirTb4b4b4.Te6edf3deleteRecursivelyTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`a manifest written before terrain existed still decodes, defaulting to no terrain`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// What OfflineRegionStore itself wrote before hasTerrain/terrainByteSize/terrainHasRegionalDetail existed —

T8b949e// no trace of those fields at all, which is exactly what a manifest already on a user's device looks like.

Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Ta5d6ffmanifest.jsonTa5d6ff"Tb4b4b4)

Tb4b4b4.Te6edf3writeTextTb4b4b4(

Ta5d6ff"""

Ta5d6ff [{Ta5d6ff"Ta5d6ffidTa5d6ff"Ta5d6ff:Ta5d6ff"Ta5d6ffabcTa5d6ff"Ta5d6ff,Ta5d6ff"Ta5d6ffsouthLatTa5d6ff"Ta5d6ff:1.0,Ta5d6ff"Ta5d6ffwestLonTa5d6ff"Ta5d6ff:2.0,Ta5d6ff"Ta5d6ffnorthLatTa5d6ff"Ta5d6ff:3.0,Ta5d6ff"Ta5d6ffeastLonTa5d6ff"Ta5d6ff:4.0,Ta5d6ff"Ta5d6ffminZoomTa5d6ff"Ta5d6ff:5,Ta5d6ff"Ta5d6ffmaxZoomTa5d6ff"Ta5d6ff:6,

Ta5d6ff"Ta5d6fftileCountTa5d6ff"Ta5d6ff:7,Ta5d6ff"Ta5d6ffbyteSizeTa5d6ff"Ta5d6ff:8,Ta5d6ff"Ta5d6ffcreatedAtEpochSecondsTa5d6ff"Ta5d6ff:9}]

Ta5d6ff"""

Tb4b4b4.Te6edf3trimIndentTb4b4b4(Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tff7b72val Te6edf3regions Tff7b72= Te6edf3storeTb4b4b4.Te6edf3listTb4b4b4(Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3regionsTb4b4b4.Te6edf3sizeTb4b4b4)

Tff7b72val Te6edf3region Tff7b72= Te6edf3regionsTb4b4b4.Te6edf3singleTb4b4b4(Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4, Te6edf3regionTb4b4b4.Te6edf3idTb4b4b4)

Te6edf3assertFalseTb4b4b4(Te6edf3regionTb4b4b4.Te6edf3hasTerrainTb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff0LTb4b4b4, Te6edf3regionTb4b4b4.Te6edf3terrainByteSizeTb4b4b4)

Te6edf3assertFalseTb4b4b4(Te6edf3regionTb4b4b4.Te6edf3terrainHasRegionalDetailTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`totalBytes sums both the base archive and any terrain attached to it`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Te6edf3storeTb4b4b4.Te6edf3addTb4b4b4(Te6edf3baseRegionTb4b4b4(Te6edf3id Tff7b72= Ta5d6ff"Ta5d6ffaTa5d6ff"Tb4b4b4, Te6edf3byteSize Tff7b72= T79c0ff1T79c0ff0T79c0ff0LTb4b4b4, Te6edf3terrainByteSize Tff7b72= T79c0ff0LTb4b4b4)Tb4b4b4)

Te6edf3storeTb4b4b4.Te6edf3addTb4b4b4(Te6edf3baseRegionTb4b4b4(Te6edf3id Tff7b72= Ta5d6ff"Ta5d6ffbTa5d6ff"Tb4b4b4, Te6edf3byteSize Tff7b72= T79c0ff2T79c0ff0T79c0ff0LTb4b4b4, Te6edf3terrainByteSize Tff7b72= T79c0ff5T79c0ff0LTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff3T79c0ff5T79c0ff0LTb4b4b4, Te6edf3storeTb4b4b4.Te6edf3totalBytesTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`deleting a region also deletes its terrain directory`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Te6edf3storeTb4b4b4.Te6edf3addTb4b4b4(Te6edf3baseRegionTb4b4b4(Te6edf3id Tff7b72= Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4)Tb4b4b4)

Tff7b72val Te6edf3terrainDir Tff7b72= Te6edf3storeTb4b4b4.Te6edf3terrainDirTb4b4b4(Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4)

Te6edf3terrainDirTb4b4b4.Te6edf3mkdirsTb4b4b4(Tb4b4b4)

Te6edf3FileTb4b4b4(Te6edf3terrainDirTb4b4b4, Ta5d6ff"Ta5d6ffglobal/5/1/1.webpTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3apply Tb4b4b4{ Te6edf3parentFileTff7b72?.Te6edf3mkdirsTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4.Te6edf3writeBytesTb4b4b4(Te6edf3byteArrayOfTb4b4b4(T79c0ff1Tb4b4b4, T79c0ff2Tb4b4b4, T79c0ff3Tb4b4b4)Tb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3terrainDirTb4b4b4.Te6edf3existsTb4b4b4(Tb4b4b4)Tb4b4b4)

Te6edf3storeTb4b4b4.Te6edf3deleteTb4b4b4(Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4)

Te6edf3assertFalseTb4b4b4(Te6edf3terrainDirTb4b4b4.Te6edf3existsTb4b4b4(Tb4b4b4)Tb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3storeTb4b4b4.Te6edf3listTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`add replaces an existing region with the same id, terrain fields included`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Te6edf3storeTb4b4b4.Te6edf3addTb4b4b4(Te6edf3baseRegionTb4b4b4(Te6edf3id Tff7b72= Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4, Te6edf3hasTerrain Tff7b72= Tff7b72falseTb4b4b4)Tb4b4b4)

Te6edf3storeTb4b4b4.Te6edf3addTb4b4b4(Te6edf3baseRegionTb4b4b4(Te6edf3id Tff7b72= Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4, Te6edf3hasTerrain Tff7b72= Tff7b72trueTb4b4b4, Te6edf3terrainByteSize Tff7b72= T79c0ff4T79c0ff2LTb4b4b4)Tb4b4b4)

Tff7b72val Te6edf3regions Tff7b72= Te6edf3storeTb4b4b4.Te6edf3listTb4b4b4(Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3regionsTb4b4b4.Te6edf3sizeTb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3regionsTb4b4b4.Te6edf3singleTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3hasTerrainTb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff4T79c0ff2LTb4b4b4, Te6edf3regionsTb4b4b4.Te6edf3singleTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3terrainByteSizeTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`writing the manifest leaves no temp file behind and the real manifest is immediately readable`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Te6edf3storeTb4b4b4.Te6edf3addTb4b4b4(Te6edf3baseRegionTb4b4b4(Te6edf3id Tff7b72= Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4)Tb4b4b4)

T8b949e// Write-then-rename: the intermediate file must never survive a completed write.

Te6edf3assertFalseTb4b4b4(Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Ta5d6ffmanifest.json.tmpTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3existsTb4b4b4(Tb4b4b4)Tb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Ta5d6ffmanifest.jsonTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3existsTb4b4b4(Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3storeTb4b4b4.Te6edf3listTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3sizeTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`a manifest write never leaves manifest json half-written`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

T8b949e// Simulates a process death mid-write: a stray temp file with a torn/partial write must never be mistaken

T8b949e// for the real manifest, and must not stop a subsequent, complete write from succeeding.

Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Ta5d6ffmanifest.json.tmpTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3writeTextTb4b4b4(Ta5d6ff"""Ta5d6ff[{Ta5d6ff"Ta5d6ffidTa5d6ff"Ta5d6ff:Ta5d6ff"Ta5d6ffpartialTa5d6ff"Ta5d6ff,Ta5d6ff"Ta5d6ffsouthLatTa5d6ff"Ta5d6ff:Ta5d6ff"""Tb4b4b4)

Te6edf3storeTb4b4b4.Te6edf3addTb4b4b4(Te6edf3baseRegionTb4b4b4(Te6edf3id Tff7b72= Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertFalseTb4b4b4(Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Ta5d6ffmanifest.json.tmpTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3existsTb4b4b4(Tb4b4b4)Tb4b4b4)

Tff7b72val Te6edf3regions Tff7b72= Te6edf3storeTb4b4b4.Te6edf3listTb4b4b4(Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3regionsTb4b4b4.Te6edf3sizeTb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffabcTa5d6ff"Tb4b4b4, Te6edf3regionsTb4b4b4.Te6edf3singleTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3idTb4b4b4)

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffbaseRegionTb4b4b4(Te6edf3idTb4b4b4: Tffa657StringTb4b4b4, Te6edf3byteSizeTb4b4b4: Tffa657Long Tff7b72= T79c0ff0LTb4b4b4, Te6edf3hasTerrainTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72falseTb4b4b4, Te6edf3terrainByteSizeTb4b4b4: Tffa657Long Tff7b72= T79c0ff0LTb4b4b4) Tff7b72=

Te6edf3OfflineRegionTb4b4b4(

Te6edf3id Tff7b72= Te6edf3idTb4b4b4,

Te6edf3southLat Tff7b72= T79c0ff0.0Tb4b4b4,

Te6edf3westLon Tff7b72= T79c0ff0.0Tb4b4b4,

Te6edf3northLat Tff7b72= T79c0ff1.0Tb4b4b4,

Te6edf3eastLon Tff7b72= T79c0ff1.0Tb4b4b4,

Te6edf3minZoom Tff7b72= T79c0ff5Tb4b4b4,

Te6edf3maxZoom Tff7b72= T79c0ff1T79c0ff0Tb4b4b4,

Te6edf3tileCount Tff7b72= T79c0ff1Tb4b4b4,

Te6edf3byteSize Tff7b72= Te6edf3byteSizeTb4b4b4,

Te6edf3createdAtEpochSeconds Tff7b72= T79c0ff0LTb4b4b4,

Te6edf3hasTerrain Tff7b72= Te6edf3hasTerrainTb4b4b4,

Te6edf3terrainByteSize Tff7b72= Te6edf3terrainByteSizeTb4b4b4,

Tb4b4b4)

Tb4b4b4}